home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / graphics / utils / videotracker / utils2 / slicer_doc < prev    next >
Text File  |  1993-03-13  |  22KB  |  563 lines
  1.  
  2. Slicer 2.1:
  3.  
  4.    Slicer is a program for creating abstract art based on mathematical
  5. functions, such as the Mandelbrot set, Julia sets, and related abstractions
  6. (chaotic dynamical systems). Features include; fast fixed or floating point
  7. arithmetic, many different functions (z²+c, z³-3a²z+b, sin(z) ...), many
  8. computation options (level sets, binary decomposition, epsilon cross,
  9. distance estimate), many coloring and rendering options, images may be
  10. recolored without recomputing, batch mode, focus, multi pass, zoom in, zoom
  11. out, pan, quick 2x zoom, and four dimensional navigation. The program is
  12. named "Slicer" because the pictures it makes can be thought of as cross
  13. sections or "slices" revealing the insides of solid (if imaginary) objects.
  14.  
  15.    For those who remember Slicer 1.x, forget it. This program is completely
  16. new, faster, more powerfull, easier to use, and I hope easier to
  17. understand.
  18.  
  19.  
  20. ************************************************************************
  21.  
  22. Distribution:
  23.  
  24.    Copyright 1992 by Gary Teachout
  25.  
  26.    This program is freeware, and may be distributed freely. It may be
  27. distributed along with other freely distributable software. It may not be
  28. sold for profit, or included as part of a commercial software product. No
  29. donations are required but they would be accepted and appreciated.
  30.  
  31.  
  32. ************************************************************************
  33.  
  34. Disclaimer:
  35.  
  36.    THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  37. EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ITS FITNESS FOR ANY
  38. PARTICULAR PURPOSE. This software is experimental and IT HAS DEFECTS, if
  39. you do not accept all of the risks and responsibilities of using defective
  40. software, then DO NOT USE THIS.
  41.  
  42.  
  43. ************************************************************************
  44.  
  45. Requirments:
  46.  
  47.    Slicer needs lots of memory, 1Mb of ram or more is best. On a 1Mb system
  48. you can use 640x400 screens with about 2000 bytes to spare, overscan will
  49. require more ram.
  50.  
  51.    To save picture files the, ILBM.Library must be in your LIBS: directory.
  52. It is included and may be installed by clicking the "Instal-ILBM-Lib" icon.
  53.  
  54.  
  55. ************************************************************************
  56.  
  57. Acknowledgments:
  58.  
  59.    I would like to thank the following for helping to make Slicer work as
  60. well as it does, and for saving me a lot of work:
  61.  
  62.    Justin V. McCormick, for the PathMaster file selector.
  63.  
  64.    Software Dissidents, for the ILBM.Library.
  65.  
  66.  
  67. ************************************************************************
  68.  
  69. Getting started:
  70.  
  71.    You may start Slicer by double clicking its icon, or a Slicer project
  72. icon, or you may run it from the CLI, or a script (see "Batch mode" below).
  73. When you start Slicer, you will first see the screen format requester. The
  74. default is a 320 X 200 screen with 32 colors, low res screens will be
  75. completed faster than high res screen. Click the "START" button, if a file
  76. was specified Slicer will load and begin working on it, otherwise it will
  77. begin computing a default image of the Mandelbrot set.
  78.  
  79.  
  80. ************************************************************************
  81.  
  82. Screen Format Requester:
  83.  
  84.    When Slicer starts out you will see the screen format requester. Select
  85. the screen size and number of colors you wish to work with, then click the
  86. "start" button. Note that Slicer can create overscan sized images, but it
  87. does not display them in overscan.
  88.  
  89.  
  90. ************************************************************************
  91.  
  92. Palette Requester:
  93.  
  94.    To change the colors in the screens palette, select the "Palette" item
  95. from the "Picture" menu, and the palette requester will be displayed.
  96. Select the color to be changed by clicking that color in the grid on the
  97. right of the requester, the selected color will be marked with a solid box,
  98. the previously selected color will be marked with a dotted box. The
  99. selected color may be changed by moving either the red, green, blue,
  100. (R,G,B) or hew, saturation, luminance, (H,S,L) sliders. To create a
  101. continuous range of colors, select and set the color at one end of the
  102. range, select and set the color at the other end of the range, then click
  103. the "RANGE" button.
  104.  
  105.  
  106. ************************************************************************
  107.  
  108. Color Maps, and the Color Map Requester:
  109.  
  110.    The color map is used to specify how the screens palette colors are used
  111. within the picture. For each pixel in an image, Slicer computes a number
  112. called the dwell, the color map specifies which palette colors are used for
  113. each dwell value. The "Color Map" item from the "Picture" menu has an array
  114. of subitems that will create an assortment of convenient color maps. Each
  115. time you create a new image (by zooming or using any item from the "Slice"
  116. menu), it will be necessary to try a few new color maps.
  117.  
  118.    Selecting the "Edit" subitem will bring up the color map requester for
  119. customizing the color map. The graph at the top is a hystogram of the dwell
  120. values for the slice. With the "RANGE" button, you can fill in part of the
  121. color map with a range of colors.
  122.  
  123.  
  124. ************************************************************************
  125.  
  126. Edit Slice Specs Requesters:
  127.  
  128.    With these requesters you may specify which abstraction you want to see,
  129. the location, orintation, magnification, and other details of the slice.
  130.  
  131. Specs Requester:
  132.  
  133.    Dwell Limit             Maximum number of iterations. Generaly the
  134.                            larger this number is, the more detail will be
  135.                            revailed, and the longer it will take to
  136.                            complette the picture. As you increase
  137.                            magnifcation (zoom in) you will also need to
  138.                            increase the dwell limit. See the "Arithmetic"
  139.                            section below.
  140.  
  141.    Magnification           The zoom factor. The larger the magnification,
  142.                            the smaller the area of the slice covered in the
  143.                            image.
  144.  
  145.    Location                These four variables specify the location in
  146.                            four dimensions of the point in the center of
  147.                            the image. "x", and "y" are the components of
  148.                            the complex variable "z" (the orbiting or
  149.                            chaotic variable). "a", and "b" are the
  150.                            components of the complex variable "c" (the
  151.                            fixed or reference variable).
  152.  
  153.    Extra Variables
  154.                            These four variables have differant meenings for
  155.                            differant functions. "f", and "g" may be the
  156.                            components of the complex variable "h". "q" and
  157.                            others may be used as escape thresholds. See the
  158.                            "Arithmetic" section below.
  159.  
  160.    Mouse Location          These buttons set the location or magnification
  161.    Mouse Magnification     to that of the region previously selected with
  162.                            the mouse. See "Regions" below.
  163.  
  164.  
  165.    Orientation             These buttons set the plane of the slice
  166.                            parallel to one of the six orthogonal planes.
  167.                            You are not limited to these six planes, see the
  168.                            "Move Requester" below.
  169.  
  170.       a b                  This plane is parallel to the Mandelbrot set
  171.                            (the fixed or reference plane).
  172.  
  173.       x y                  This plane is a Julia set (the plane where
  174.                            chaotic motion takes place).
  175.  
  176.       a x                  These planes have each dimension aligned with
  177.       a y                  one dimension of each of the planes above.
  178.       x y                  Allowing you to see slices perpendicular (edge
  179.       y b                  on) to the Mandelbrot and Julia sets.
  180.  
  181.    Arithmetic              The up and down arrow buttons allow you to
  182.                            select which function you wish to see, and the
  183.                            numerical precision. See the "Arithmetic"
  184.                            section below.
  185.  
  186.    Specs                   With these buttons you may switch between the